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INTRODUCTION 

This Installation Guide describes the procedure for 
generating a configuration of Turbo-Plus in a system which 
includes 16-bit boards. 

For information on the 8-bit installation, refer to the 8- 
bit Installation Guide to Turbo-Plus . For information on using 
the package refer to the User’s Guide to Turbo-Plus . That 
document includes an overview of the package, and instructions on 
using each command. 

Turbo-Plus is designed with the ability to be patched to run 
on systems with different search drives. Since it needs to know 
what drive this is, it is set up as a patchable parameter. Thus, 
most of Turbo-Plus’s modules are distributed as relocatable (.0) 
files, so that parameters may be ’plugged in’ in the installation 
procedure using the TurboDOS symbolic patch facility described in 
the Configuration Guide to TurboDOS . 

Section 2 of this guide briefly describes all of the modules 
sent as part of the 16-bit Turbo-Plus package, and explains where 
on the system they should be placed. 

Section 3 describes the installation procedure for 
generating a customized version of Turbo-Plus excluding the 
background batch processor, which involves some extra steps. 

Section 4 describes the installation procedure for the le¬ 
ft • t. background batch processor. 
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Overview 

Turbo-Plus makes extensive use of the TurboDOS User Defined 
Function (TurboDOS call 0x29) and follows the USBSUP calling 
protocol, outlined in your TurboDOS 1.41 update notes, and in 
Appendix G of the 8-bit installation manual. Therefore, if you 
wish to add your own functions with this call, it is imperative 
that you also follow the USRSUP protocol, which has been adopted 
by Software 2000 as the standard TurboDOS method. 


Serialization 

Bach copy of Turbo-Plus is serialized to be run only on a 

•n o r» + i Ail Tot* Tn T»hr»TTn.Q i « d owol om TVi a o o t» o T ruimb o t* 
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coincides with that of the operating system on which it is to be 
run. None of the modules in Turbo-Plus will run on any system 
with a serial number different that its own. 
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Turbo-Plus 16-bit Installation 
Check List 

THIS CHECKLIST IS FOB FUBE 16 BIT INSTALLATIONS ONLY 


[ ] 1. Bead the Turbo-Plus 16-bit Installation Guide. 

[ ] 2. Bun INSTALL.OMB. 

This program will prompt you for your TurboDOS version, 
your system boot drive, and your system search drive. 
It will then create the proper .PAR files for your 
configuration and proceed to GEN the Turbo-Plus 
modules. When GEN is complete, it will copy all of the 
appropriate files to their correct destinations on your 
system. 

f 3 3. Bun BBIN3TAL.CMD ! OPTIONAL! 

If you desire to use the Background Batch commands, it 
will be necessary to run this installation program. 
BBINSTAL will ask the same questions as above and in 
addition will require a particular user area 
designation where it can reside when idle and maintain 
it’s files. 

[ 3 4. COPY all help (.HLP) files from Distribution Disk(s) 

to user 0 of your search drive. 

[ ] 6. COPY TPLUSS.O, TPLUSM.O, C0N96TP.0, CONBB.O, TWXTV.O 

and TWXNUL.O to the area of your disk where you 
generate your TurboDOS systems. 

[ ] 6. GEN all Slaves - Be sure that each OSSLAVEx.GEN 

includes C0N96TP.0 (replacing your existing C0N96.0), 
TPLUSS.O and TWXTV.O (or TWXNUL.O), as well as 
USBSUP.O, NETSVC.0 and NETFWD.O (all supplied by 
Software 2000. Inc., but not generally included in 
slave general ’ oi*) . 

[ ] 7. GEN Background Batch slave. .OPTIONAL! 

[ ] a. In order to allow the BATCH PBOCESSING slave to recover 
from console input conditions (illegal in BB), 
substitute CONBB.O for C0N96TP.0 on the OSSLAVEx.GEN 
designated in the BBINSTAL session. 

[ ] b. Include LOGUSB = NN (where NN = user area specified in 
BBINSTAL - i.e. LOGUSB = OxlE for area 30) in this 
OSSLAVEx.PAB file. 

(Cont’d) 
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[ ] 8. If you are running a 16-bit master, GEN the master 

(OSMASTER.SYS). 

Be sure to include TPLUSM.O as well as USRSUP.O, 
NETFWD.O, NETBEQ.O and MSGFMT.O (supplied by Software 
2000, Inc.) in the OSMASTER.GEN file. 

[ ] 9. Reset and test your system. You should first notice 

the new Turbo-Plus LOGON program if everything is 
properly installed. 
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Turbo-Plus Modules 

16 bit Turbo-Plus will arrive on two sides of one CP/M 
format single-sided single-density diskette. Side one contains 
all of the relocatable modules; side two contains .DO, .GEN, and 
.PAR files used to generate your Turbo-Plus installation. 

Program Modules 

Side one contains three types of files; 

1) Relocatable program files: 

Those files which constitute the main bodies of the 
Turbo-Plus utility programs. 

2) Relocatable subroutine files: 

Those files which contain subroutines called by the 
programs above. 

3 ) System function files: 

Files containing extensions to the normal set of 
TurboDOS operating system calls which must be genned 
into the operating system. 

Side two contains all of the supporting files used for 
generating your installed version of Turbo-Plus. This includes 
.GEN and .PAR files for your programs, auxiliary data files, two 
installation ,CMD files, and .DO files referenced by the install 
programs. 
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Relocatable and executable program files 

Tb.ese are all of tbe files containing tbe assembled source 
code for the Turbo-Plus utilities. They are distributed in 
relocatable form, to allow the patching of parameters. 


DIRDUMP.0 

GO. 0 

GONAME.0 

HELP. 0 

LOCATE.0 

LOG. 0 

LOGOFF.0 

LOGON.0 

MAIL.0 

MAQ'T’TP.'R n 

PROFILE.0 
RESET.0 
STATUS.0 

TWX.O 

USER. 0 

WHO. 0 


Program which gives a master directory of any disk, 
sorted by user area. 

Program which moves users to a user area specified 
by a user-defined name. 

Utility which allows users to define names for user 
areas on the system. 


TurbojjOS on-line help facility providing hel 
all TurboDOS and Turbo-Plus commands. Users 
add their own help files. 


* 


may 


Utility to search certain or all system drives for 
given file or template. 


Utility to make entries in a date and time stamped 
log file. 


Enhanced version of system logoff, notifying users 
of pending mail, and displaying system bulletins. 


Enhanced version of system logon, notifying users 
of pending mail, displaying system bulletins, and 
providing additional levels of security. 

TurboDOS mail facility to allow electronic mail to 
be sent among users on the system. 

Enhanced version of the TurboDOS ’MASTER’ command, 
providing better control of access to the master. 


Program to maintain USERID.SYS file. 

Program to reset a slave from another slave. 

Facility to continuously monitor activity of system 
users, printers, and buffers. 

TWX facility to allow users to send immediate 
messages to other consoles on the system. 

Allows user to change user areas. Performs the 
same function as the TurboDOS USER command of 
versions 1.3 and earlier. 


System status facility to display all current users 
on the system, processes they are running and other 
current system characteristics. 
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Relocatable subroutine files 


A number of routines are shared by various program modules 
include the following files: 


They 


DBUFF. 0 
LOGDAT.0 
PTABLE.O 
TPDATE.O 


GBUFF.0 
MBUFF.O 
TABLES.0 
TPSCAN.0 


LOGCHK.0 
MROUTE.0 
TPMOD.O 


System function files 

These files must be moved to the user area on the system where 
your system’s .GEN and .PAR files reside, and where your system 
generation takes place. Some of them must be genned into your 
system in order for Turbo-Plus to work. There are six such 
files, all on side 1: 

TPLUSS.O TPLUSM.O 

TWXNUL.0 TWXTV.0 

C0N96TP 0 CONBB.O 


♦ GEN and .PAR files 

xhe^e files are necessary to patch the modules to work under your 
system configuration. 


All of the following programs have .GEN files, some of which are 
accompanied by ,PAR files: 


DIRDUMP 

LOCATE 

MAIL 

STATUS 


GO 

LOG 

MASTER 

TWX 


GONAME 

LOGOFF 

PROFILE 

USER 


HELP 

LOGON 

RESET 

WHO 


The following files are necessary for the installation procedure: 


TPLUS6.DO 


INSTALL.CMD 



Turbo-Plus VI.41 16-bit Installation Guide 


2-4 



Turbo-Plus VI.41 16-bit Installation Guide 


Instal1ing Turbo-Plus 
Generating executable programs 

Before you begin your Turbo-Plus installation, make a backup 
of the distribution diskette(s). If you received Turbo-Plus on a 
single TurboDOS format disk, you may run the install procedure 
directly from that disk. If not, you must copy the first two 
disks onto any user area on the system other than user zero of 
the search drive. 

To customize Turbo-Plus to your system configuration, 
execute the INSTALL command. This program will prompt you for 
your TurboDOS version number, system search drive and the drive 
which currently contains your system boot disk (do not include 
the colon after the drive letters); all of the necessary .CMD 
files will be generated and moved down to the search drive. 
Then, all of the .HLP files should be moved from the distribution 
disk to user zero of the search drive. During execution of the 
INSTALL process, it is very possible that certain stages will 
return with system error messages such as ’Pile not found 5 . This 
is due to the fact that the procedure must make sure that if any 
of these programs were already present, in an older version, they 
are deleted. Thus, if the programs were not there, trying to 
delete them will yield error messages. 

Note: If you do not have a system search drive, you must 
sci.il give some drive parameter to be used by Turbo-Plus as the 
dri^s on which to maintain all of its files. 
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System Generation 

Before Turbo—Plus may be brought up, it is necessary to 
generate a new operating system. You should start with the .GEN 
and .PAR files which you are currently using for both your 
slave(s) and your master, but some additions will be necessary. 

Generating a new system master 

The following changes must be made to the .GEN file for your 
system master (usually STDMASTR.GEN or OSMASTER.GEN). Using your 
system editor, insert the following lines. 

NETREQ 

MSGFMT 

■ M1JIMTJI TTN 

PLCixrwu 

USRSUP 

TPLUSM 

If you have the ability to use the TWX and RESET commands, 
it is recommended that you use modified circuit drivers. Many 
existing circuit drivers have already been modified 
appropriately; if your dealer says that yours has not been, a 
revision will be necessary. There should be no change made to 
the master circuit driver, and the source for your slave circuit 
driver should be changed, following the instructions in Appendix 
A. 

If you are running a multi-circuit system, one patch line 
will be required in your master .PAR file. For a full 
explanation of this patch point, refer to Appendix B in the 8-bit 
installation manual. 

Figure 3.1 shows a sample OSMASTER.GEN file prepared for 
Turbo-Plus. 
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STDMASTR 

NETFWD 

NETHEQ 

MSGFMT 

HDWNIT 

USRSUP 

TPLUSM 

CONREM 

LSTPAR 

LSTETX 

LSTTAB 

SPDXXX 

BRTXXX 

RTCXXX 

DSKXXX 

DST58F 

DSKHHE 

MCDXXX 


COMPAT 

NMBSVC 

NMBXXX 

NMBMBS 

NMBUFS 

NMBRPS 

PATXXX 

DSKAST 


PTRAST 


MEMRES 

DSPPAT 


AUTUSR 

QUEAST 

SRHDRV 
ETXBR = 
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Figure 3.1 

Sample OSMASTER.GEN file 

; STANDARD NETWORK MASTER CONFIGURATION 
; NETWORK MESSAGE FORWARDING 
; NETWORK REQUEST PROCESSOR 
; NETWORK MESSAGE FORMAT TABLE 
; HARDWARE INITIALIZATION 
; USER FUNCTION MAIN CALLING MODULE 
; TURBO-PLUS FUNCTION EXTENSIONS 
; REMOTE MASTER CONSOLE 
; DRIVER FOR HIGH SPEED PRINTER 
; DRIVER FOR LETTER QUALITY PRINTER 
; DRIVER FOR HIGH SPEED PRINTER EXPANDING TABS 
; SERIAL & PARALLEL DRIVERS 
; BAUD-RATE TABLES 
; REAL-TIME CLOCK DRIVER 
; FLOPPY DISK DRIVER 
; FLOPPY DISK SPECIFICATION TABLES 
; HARD DISK DRIVER 
; MASTER CIRCUIT DRIVER 

Figure 3.2 

Sample OSMASTER.PAR file 


OxFO 

; Compatibility flags 

9 

; Numb e r 

of slaves 

9 

; Number 

of slaves (9) 

OxlB 

; Number 

of message buffers (27) 

0x10 

; 16 I/O 

buffers 

OxlB 

; Numb e r 

of network reply packet 


0x60,0x62,0x64,0x66,0x68,0x6A,0x6C,0x6E,0x70 

; Slave Port assignment table 

00,DSKDRA,01,DSKDRA,00,DSKDRB,01,DSKDRB,02,DSKDRB,03,DSKDRB, 
04,DSKDRB,06,DSKDRB,06,DSKDRB,07,DSKDRB,08,DSKDRB,09,DSKDRB, 
OxOA,DSKDRB,OxOB,DSKDRB 

; Disk assignment table: 

A,B = floppy drives 
; C-N ■ Winchester disk 


(0x1000) 

1 , 2 , 0 , 0 , 0 , 0 , 0 , 0 , 


0x80 

00 ,( 0 ), 00 ,( 0),00 


= 00,LSTDRA,01,LSTDRB,00,LSTDRC 

Printer assignment table: 

A = High speed with raw output 
B = Letter quality with raw output 
C = High speed w/ formatted output 
Reserved memory above TPA 
, 0,0 

De-Spool table: 

Printer A —> Queue A 
Printer B —> Queue B 
Log master on to user 0, privileged 
( 0 ), 00 ,( 0 ), 00 ,( 0 ), 00 ,( 0 ), 00 ,( 0 ), 00 , ( 0 ) 
Define eight valid queues (A-H) 

: 8 ; System search drive = H 

OxOE : Baud rate on Printer B = 9600 
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Generating new slaves 


Next, in your slave .GEN files, add lines containing TJSRSTTP 
and TPLUSS following the hardware initialization module. You 
should also include NETFWD and NETSVC immediately after the line 
for STDSLAVE. Also, to optimize the performance of the TWX 
command, you need a special console driver, modified circuit 
drivers, and a separate module to handle the shift—in shift—out 
produced by TWX. 


If your standard console driver is C0N96, you may use the 
C0N96TP driver provided with Turbo-Plus. (To do so, simply 
replace the C0N96 line in your .GEN file with C0N96TP). If not, 
you should modify your driver such that before every console 
output, it performs a WAIT operation on the global semaphore: 


rnT.TT nnxr 

J. *1 iJWWU , 


an/4 


Ail + nil t 
w u wy u w 


4 +. nauf nnmo 

* - r B - * w * 


.Q T fTKf L T. 


operation on the same semaphore. It should also allow for a 

character to remove the TWX message from the 25th line of the 

screen, by calling the external routine TWXRST when this 

character is received. C0N96TP uses the ESC character by 

d e f auIt, and if the re is no me s s age o n t h e s t a t us 1in e, it allows 
the escape to passed through normally. Figure 3.5 shows the 
C0N96TP driver, which may be used as a guideline. 


Furthermore, for those of you using TWX and RESET, your 
circuit driver may require modification. Consult appendix A for 
the necessary changes. 

The second module necessary for TWX handles the placing of 
TWX messages on the screen without interrupting normal console 
input/output. If you are using a Televideo terminal, you may use 
the TWXTV module, which places all received TWX messages on the 
terminal status line. For any other terminal you may use the 
TWXNUL module, which simply prints each line at the current 
cursor position, followed by a carriage return-line feed 
sequence. A source listing of this module is provided and 
explained in Figure 3.6, in case you wish to modify it for your 
specific terminal. Modification may be done either by writing 
your own driver, our patching TWXNUL in the slave .PAR file. 

Figure 3.4 shows a sample slave .GEN file and figure 3.3 
shows the corresponding .PAR file. 


Once all of these changes are complete, you are ready to 
generate the new master and slaves using the GEN command in the 
usual way. (Refer to the TurboDOS configuration Guide.) Once all 
of these steps are done, copy the newly created .SYS files down 
to user zero of your boot disk, and Turbo-Plus will be ready to 
come up. 
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COMPAT = OxFO 
SRHDRV = 8 
PRTMOD =01 
QUEPTR = 1 
SPLDRV = 8 


STDSLAVE 

NETFWD 

NETSVC 

MITXXX 

USRSUP 

TPLIJSS 

C0N96TP 

TWXTV 

SPDXXX 

SLVRES 

SGDXXX 


Figure 3.3 

Sample STDSLAVE.PAR file 

; File Compatibility flags 
; System search drive = H 
; Print mode = Spooled 
; Default Queue = A 
; Spool Drive = I 


Figure 3.4 

Sample STDSLAVE.GEN file 

; STANDARD NETWORK SLAVE CONFIGURATION 
; NETWORK MESSAGE FORWARDING 
; NETWORK SERVICE PROCESS 
; HARDWARE INITIALIZATION 
; USER FUNCTION INTERFACE 
i TURBO-“PLUS FUNCTION EXTENSIONS 
; TURBO-PLUS ASCII CONSOLE AT 9600 BAUD 
; TWX CONSOLE MANAGER FOR TELEVIDEO 950/926/800 
; SERIAL & PARALLEL DRIVERS 
1 SUBROUTINE FOR KEYBOARD RESET OF SLAVE 
; SLAVE CIRCUIT DRIVER 


Special hardware-dependent modules, 
above, are in boldface. 


described in the paragraphs 
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Figure 3.5 

Sample Turbo-Plus Console Driver 
C0N96TP: TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 

Page 1 


; COPYRIGHT 1984, SOFTWARE 2000, INC. 

; VERSION: 01/03/84 

; Edit History: JBG : 24-Aug-83 : Revised for TurboDOS VI.30 

; JBG : 12-Mar-84 : 16 bit conversion completed 

; JBG : 3-Dec-84 : Clear status line logic added 

MODULE "C0N96TP" ;MODULE NAME 

#INCLUDE "DREQUATE” ;DRIVER SYMBOLIC EQUIVALENCES 


LOC Data# ;LOCATE IN DATA SEGMENT 


CONBR: : 

BYTE 

0x8E 

;CONSOLE BAUD RATE CODE (9600 BAUD) 

R25CHR: 

BYTE 

OxlB 

; RESTORE 25TH LINE CHARACTER 

FFCHR: : 

BYTE 

AFF 

; FORM FEED CHARACTER 

INITC: 

BYTE 

0 

; INITIALIZATION COMPLETE FLAG 

EFLAG: 

BYTE 

0 


BCOUNT: 

BYTE 

0 


SCOUNT: 

WORD 

0 



LOC 

Code# 

; LOCATE IN CODE SEGMENT 

CONDR_: 

:MOV 

AL,INITC 

; GET INIT COMPLETE FLAG 


TEST 

AL.AL 

; INITIALIZATION COMPLETE FLAG SET? 


JNZ 

_CDRV 

; IF SO, CONTINUE 


GALL 

INIT 

; ELSE, INITIALIZE CONSOLE CHANNEL 

_CDRV: 

MOV 

AL, DL 

; GET FUNCTION NUMBER 


SUB 

AL, =8 

; FUNCTION NUMBER=8? 


JNZ 

JMP 

NSO 

CONSO 

; IF SO, ERROR SHIFT OUT 

NSO: 


DEC 

AL 

; FUNCTION NUMBER-9? 


JNZ 

JMP 

NS I 
CONS I 

; IF SO, ERROR SHIFT IN 

_NSI: 


DEC 

AL 

; FUNCTION NUMBER = 10? 


JNZ 

JMP 

NOPT 

OPT 

; IF SO, JUMP TO OPTIMIZED OUTPUT ROUTINE 

_NOPT: 

MOV 

AL, DL 

; GET BACK IN A 


OR 

AL, AL 

; IF 0, GO TO CONSTAT 


JZ 

CONST 

J , 


DEC 

AL 

; IF 1, CONIN 


JZ 

CONIN 

J * 


DEC 

AL 

; IF 2, CONOUT 
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C0N96TP: TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 

Page 2 


S* 


INIT; 


nitx 


CONIN' 


SER: 


RET: 


JNZ 

S 

JMP 

CONOUT 

JMP 

SERIAL# 

MOV 

INITC s “GxFF 

PUSH 

DX 

PUSH 

CX 

MOV 

CL,CONBB 

MOV 

DL, =3 

CALL 

SERIAL# 

MOV 

AL.FFCHR 

TEST 

AL, AL 

JZ 

NITX 

POP 

CX 

PUSH 

CX 

MOV 

CL, AL 

MOV 

DL, =2 

CALL 

SERIAL# 

POP 

CX 

POP 

DX 

RET 



MOV 

AL.EFLAG 

OR 

AL, AL 

JZ 

SER 

XOR 

AL, AL 

CALL 

RELEAS 

PUSH 

CX 

PUSH 

DX 

CALL 

SERIAL# 

PUSH 

AX 

AND 

AL,=0x7F 

MOV 

CH, AL 

MOV 

AL,R25CHR 

CMP 

AL, CH 

JNZ 

RET 

MOV 

AL,LINE25# 

OR 

AL, AL 

JZ 

RET 

CALL 

TWXRST# 

POP 

AX 

POP 

DX 

POP 

CX 

JMP 

SERIAL# 

POP 

AX 

POP 

DX 

POP 

CX 


; SET INIT COMPLETE FLAG 
; SAVE FUNCTION NUMBER 
; SAVE CHANNEL NUMBER/CHARACTER 
; GET CONSOLE BAUD RATE CODE 
; SET FUNCTION NUMBER=3 
; SET CHANNEL BUAD RATE 
; GET FORM FEED CHARACTER 
;FORM FEED CHARACTERS? 

; IF SO, CONTINUE 
;ELSE, RESTORE CHANNEL NUMBER 
; SAVE CHANNEL NUMBER 
; FORM FEED CHARACTER TO C-REG 
; SET FUNCTION NUMBERS 
; OUTPUT FORM FEED 
; RESTORE CHANNEL NUMBER/CHARACTER 
;RESTORE FUNCTION NUMBER 
; DONE 


IF ESCAPE FLAG IS SET 


RESET FLAGS AND SEMAPHORE 
END IF 

SAVE CHANNEL NUMBER 
AND FUNCTION NUMBER 
GET THE CHARACTER 
SAVE IT 
STRIP PARITY 
SAVE IT 

COMPARE TO 26TH LINE RESTORE 
IF SO 

CHECK FOR PRESENCE OF MESSAGE 

IF NONE, SKIP THIS 

RESTORE THE LINE 

GET REGISTERS OF THE STACK 

. BECAUSE WE NEED THE FUNCTION IN E 

. AND THE CHANNEL IN B 

GO AHEAD TO SERIAL# 

ELSE 

GET CHAR BACK IN A 
RESTORE THE STACK 
ENDIF 


3-7 





Turbo-Plus VI.41 16-bit Installation Guide 


C0N96TP: TURBQDOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 

Page 3 



RET 


RETURN 


CONST: 

MOV 

AL.EFLAG 

IF ESCAPE FLAG IS SET 



OR 

AL,AL 

* 



JZ 

SER 




PUSH 

BX 

SAVE HL 



MOV 

BX.SCOUNT 

CHECK CON STAT COUNT 



INC 

BX 

BUMP IT 



MOV 

SCOUNT,BX 

SAVE NEW STAT COUNT 



MOV 

AL f BH 

IF 0 



OR 

AL, BL 




JNZ 

NR 




CALL 

RELEAS 

RELEASE ESCAPE FLAG 


_NR: 

POP 

BX 

END IF 

RESTORE HL 


_SER: 

PUSH 

CX 

END IF 

SAVE CHANNEL NUMBER 



CALL 

SERIAL# 

AND GO TO SERIAL 



POP 

DX 

GET CHANNEL NUMBER BACK IN 

D 


OR 

AL, AL 

IF NOTHING AVAILABLE, JUST 

RETURN 


JNZ 

_c 

* 



RET 


* 


_C: 






PUSH 

AX 

SAVE REGISTERS FOR RETURN 



PUSH 

CX 

* 



AND 

CL,=0x7F 

STRIP PARITY 



MOV 

CH.CL 

SAVE IT 



MOV 

AL,R25CHR 

COMPARE TO 25TH LINE RESTORE 


CMP 

AL, CH 

• 



JNZ 

RST 

IF SO 



MOV 

AL,LINE25# 

CHECK FOR PRESENCE OF MESSAGE 


OR 

AL, AL 




JZ 

RST 

IF NONE, SKIP THIS 



'CALL 

TWXRST# 

RESTORE THE LINE 



MOV 

CH, DH 

GET CHANNEL NUMBER BACK 

IN B 


MOV 

DL, =1 

CALL CONIN TO FLUSH THE 

BYTE 


CALL 

SERIAL# 




POP 

CX 

GET REGISTERS OFF STACK 



POP 

AX 




XOR 

AL, AL 

FLAG NO CHARACTER AVAILABLE 


JMP 

_RET 

ELSE 


_RST: 



♦ 



POP 

CX 

RESTORE REGISTERS NORMALLY 


POP 

AX 



_RET: 



END IF 



RET 


RETURN 


RELEAS: 

MOV 

EFLAG.AL 

► ♦ 



MOV 

BCOUNT,AL 

> • 
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C0N96TP: TUBBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT 1984, SOFTWARE 2000, INC. 

Page 4 


CONOUT: 


NSEQ: 


NESC: 


CONT: 


NE2: 


HT 1984, 

SOFTWARE 2000, 

INC. 

PUSH 

CX 

* 

SAVE REGISTERS 

PUSH 

DX 

* 


PUSH 

BX 

S 


MOV 

BX.&TWLOCK# 

t 

RELEASE CONSOLE 

CALL 

SIGNAL# 

9 

# 

POP 

BX 

t 

RESTORE REGISTERS 

POP 

DX 

3 

# 

POP 

RET 

CX 

9 

9 

END IF 

RETURN 

MOV 

AL.EFLAG 

* 

IF WE ARE IN THE MIDDLE OF AN ESCAPE 

OR 

AL, AL 

9 


JZ 

NSEQ 

9 


MOV 

AL,BCOUNT 

9 

GET BYTE COUNTER 

DEC 

AL 

9 

DECREMENT IT 

MOV 

BCOUNT , AL 

* 

STORE IT 

JNZ 

CONT 


IF IT’S ZERO 

MOV 

EFLAG,AL 

9 

TURN OFF ESCAPE FLAG 

JMP 

_CONT 

9 

END IF 

ELSE 

MOV 

AL, CL 

» 

GET BYTE IN A 

AND 

AL,“0x7F 

9 

STRIP PARITY 

CMP 

AL,=OxlB 

f 

CHECK FOR ESCAPE 

JNZ 

NESC 

> 

IF ESCAPE 

OR 

AL,=OxFF 

t 

SET FLAG 

MOV 

EFLAG,AL 

9 


INC 

AL 

9 

# 

MOV 

WORD SCOUNT,=0x00 

9 

; AND INITIALIZE STAT COUNTER 

END IF 

PUSH 

CX 


SAVE REGISTERS 

PUSH 

DX 



PUSH 

BX 



MOV 

BX,&TWLOCK# 


WAIT FOR CONSOLE FREE 

CALL 

WAIT# 



POP 

BX 


RESTORE REGISTERS 

POP 

DX 


* 

POP 

CX 


END IF 

MOV 

AL, CL 


GET BYTE IN A 

AND 

AL,=0x7F 


STRIP PARITY 

CMP 

AL,=OxlB 


IF IT’S AN ESCAPE 

JNZ 

NE2 



MOV 

AL, =6 


INITIALIZE BYTE COUNTER 

MOV 

BCOUNT,AL 



OR 

AL,=OxFF 


SET FLAG 

MOV 

EFLAG,AL 



INC 

AL 


AND INITIALIZE STAT COUNT 

MOV 

BYTE SCOUNT,AL 



MOV 

SCOUNT+1,AL 


END IF 
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CALL 

SERIAL# 

9 

PRINT THE BYTE 


MOV 

AT. , EFLAG 

9 

CHECK ESCAPE FLAG 


OR 

al’al 

s 

IF IT WAS NOT SET 


JZ 

_NR 

9 



RET 


9 

* 

_NR: 

PUSH 

cx 

» 

SAVE REGISTERS 


PUSH 

DX 

9 



PUSH 

BX 

> 



MOV 

BX, &TWL0CK# 

9 

RELEASE CONSOLE 


n A T T 
UAUJJ 

o t nvr a t u 
u x uimn rr 

9 



POP 

BX 

9 

RESTORE REGISTERS 


POP 

DX 

9 



POP 

CX 

9 

END IF 


RET 


9 

RETURN 

OPT: 

JMP 

SERIAL# 




MOV 

AL,TWLOCK# 

9 

LOOK AT TWX LOCK 


OR 

AL, AL 

9 

IF IN USE, RETURN UNSUCCESSFUL 


JNZ 

_NR 




RET 


9 


_NR: 

MOV 

AL,EFLAG 

9 

ELSE, IF IN MIDDLE OF ESCAPE SEQUENCE 


OR 

AL, AL 




JZ 

NSEQ 

9 

• 


XOR 

AL, AL 

9 

RETURN UNSUCCESSFUL 


RET 


9 


_NSEQ: 



9 

ELSE IF THE CHARACTER IS AN ESCAPE 


MOV 

AL, CL 

9 



AND 

AL,=0x7F 

9 



SUB 

AL,-AESC 

9 

RETURN UNSUCCESSFUL 


JNZ 

_NR1 




RET 




_NR1: 



9 



JMP 

SERIAL# 

9 

ELSE, JUST DO THE OUTPUT 

CONSO: 





CONSI: 

CALL 

DMS# ; POSITION 

TO NEXT LINE 


BYTE 

ACR,ALF,0 




RET 

; DONE 




END 
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Figure 3.6 

TWX Null Console Manager 

TWXNUL: Turbo-Plus TWXNUL driver 
Copyright 1985, Microserve, Inc. 

Page 1 


Default Shift-In/Shift-Out controls 

AUTHOR: Jim Gabriel 

Microserve, Inc. 

Edit History: JBG : 24-Aug-83 : Revised for TurboDOS VI.30 
JBG : 12-Mar-84 : 16 bit conversion completed 
JBG : 25-Nov-84 : 1.41 equates added 
JBG : 3”Dec-84 : Clear status line logic added 



MODULE 

"TWXNUL” 


#INCLUDE 

"DREQUATE" 


#INCLUDE 

"TEQUATE” 


LINE25: 

SICODE: 

LOG 

BYTE 

Data# 

0 


SOCODE: 

BYTE 

ACR,ALF,0x00,OxOC 

),0x00,0x00,0x00,0x00,0x00,0x00 

RSTCOD: 

BYTE 

ACR,ALF,0x00,OxOC 

),0x00,0x00,0x00,0x00,0x00,0x00 


BYTE 

o 

o 

o 

o 

o 

o 

o 

o 

),0 

« 

TWXSI: : 

LOG 

PUSHF 

Code# 

SAVE FLAGS 


PUSH 

AX 

SAVE REGISTERS 


PUSH 

cx 



PUSH 

DX 



PUSH 

BX 



MOV 

BX.&SICODE 

SET HL FOR SHIFT IN 


JMPS 

SCONT 

- 

TWXSO: : 


PUSHF 


SAVE FLAGS 


PUSH 

AX 

SAVE REGISTERS 


PUSH 

CX 



PUSH 

DX 



PUSH 

BX 



OR 

AL,=0xFF 

SIGNAL THAT A MESSAGE IS PRESENT 


MOV 

LINE25.AL 

# 


MOV 

BX,&S0C0DE 

SET HL FOR SHIFT OUT 

» 

JMPS 

SCONT 

• 
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TWXRST: : 



PUSHF 

PUSH 

AX 


PUSH 

CX 


PUSH 

DX 


PUSH 

BX 


XOR 

AL, AL 


MOV 

LINE25,AL 


MOV 

BX,&RSTCOD 

9 

n r\ A^im _ 

ouum ; 


MOV 

DH,CONAST# 

CLOOP: 


MOV 

AL,[BX] 


OR 

AL, AL 


JZ 

SRET 


MOV 

DL, AL 


MOV 

CL,=COMOUT 


PUSH 

DX 


PUSH 

BX 


XOR 

AL, AL 


CALL 

XTNTRY# 


POP 

BX 


POP 

DX 


INC 

BX 


JMP 

CLOOP 

SRET: 

POP 

BX 


POP 

DX 


POP 

CX 


POP 

AX 


POPF 

RET 



END 


SAVE FLAGS 
SAVE REGISTERS 


SIGNAL THAT NO MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 


GET CONSOLE CHANNEL IN D 
FOR EACH BYTE DO 
GET BYTE IN E 


SET PARM FOR CONOUT 
SAVE CHANNEL NUMBER 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 


RETURN 
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To modify this driver you may either write your own, or use 
the symbolic patch facility. The primary reason to write your 
own would be to perform operations other than a simple console 
output of a string of bytes, such as code to also keep track of 
the cursor position before the message. 

If you wish to do this, the module must meet the following 
specifications: It must have the global entry points TWXSI 

which will be called before every TWX line, to position the 
cursor as desired; TWXSG, which will be called after every TWX 
line, to restore the cursor; and TWXRST, which will be called to 
remove the TWX message from the 26th line. All console output 
must be done via calls to the comm channel, which is defined in 
register DH upon entry to the routine. 

yo^ir only modifications involve changing the string of 
bytes to be sent out before and after each message, it will 
probably be more convenient to use the TurboDOS symbolic patch 
facility. The routine allows for up to ten bytes to be patched 
at locations SICODE, SOCODE, and HSTCOD for the sequences to be 
sent out before the message, after the message, and to remove the 
message respectively. For example, if you wish to send out five 
bells and a clear screen at the beginning, five bells and a 
carriage return-line feed sequence at the end, and an ESCAPE, 
control-G sequence to remove the message, your .PAR file for the 
slave could be patched as follows, using TWXNUL: 

SICODE = 0x07,0x07,0x07,0x07,0x07,0x00 
SOCODE = 0x07,0x07,0x07,0x07,0x07,OxOD,OxOA 
HSTCOD = OxlB,0x07 

However, if you are using one type of terminal frequently, 
it may be easiest to write a special driver for it, even if it 
only involves changing the bytes, so that you need not change 
every .PAR file which you use. An example of such a driver is 
TWXTV, shown in Figure 3.7, written for the Televideo 800, 926, 
and 950 terminals. This driver is designed to take advantage of 
the status line of the terminal. All TWX messages will appear on 
this line, leaving the user’s screen intact. 
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Figure 3.7 

TWX Televideo Console Manager 

TWXTY: Turbo-Plus TWXTV driver 
Copyright 1985, Microserve, Inc. 

Page 1 


Shift-In/Shift-Out controls for Televideo 925/950/800 series 

AUTHOR: Jim Gabriel 

Microserve, Inc. 

Edit History: JBG : 24-Aug-83 : Revised for TurboDOS VI.30 
JBG : 12-Mar-84 : 16 bit conversion completed 
JBG : 25-Nov-84 : 1.41 equates added 
JBG : 3-Dec-84 : Clear status line logic added 


MODULE 

#INCLUDE 
#INCLUDE 

LOC 

LINE25:: 

BYTE 

SICODE:: 

BYTE 

SOCODE:: 

BYTE 

RSTCOD:: 

BYTE 

LOC 

TWXSI:: 

PUSHF 

PUSH 

PUSH 

PUSH 

PUSH 

MOV 

JMPS 

TWXSO:: 

PUSHF 

PUSH 

PUSH 

PUSH 

PUSH 

OR 

MOV 

MOV 

JMPS 


”TWXTV” 

”DREQUATE” 

”TEQUATE” 

Data# 


0 

ABEL,AESC,0x67,AESC,0x66,AESC,0x47,0x3C,0x00,0x00 
ACR,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 
AESC,0x68 , 0 , 0 , 0,0,0,0,0,0 
Code# 


AX 

CX 

DX 

BX 

BX.&SICODE 

SCONT 


SAVE FLAGS 
SAVE REGISTERS 


SET HL FOR SHIFT IN 


AX 

CX 

DX 

BX 


AL,=0xFF 
LINE25,AL 
BX,&S0C0DE 
SCONT 


SAVE FLAGS 
SAVE REGISTERS 

SIGNAL THAT A MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 
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TWXRST:: 


PUSHF 


PUSH 

AX 

PUSH 

CX 

PUSH 

DX 

PUSH 

BX 

XOR 

AL, AL 

MOV 

LINE25,AL 

MOV 

BX, &RSTC03D 


8C0NT 


CLOG?: 

MOV 

DH,CONAST# 


MOV 

AL,[BX) 


OR 

AL, AL 


JZ 

SRET 


MOV 

DL, AL 


MOV 

CL,=COMOUT 


PUSH 

DX 


PUSH 

BX 


XOR 

AL, AL 


CALL 

XTNTRY# 


POP 

BX 


POP 

DX 


INC 

BX 


JMP 

CLOOP 

SRET: 

POP 

BX 


POP 

DX 


POP 

CX 


POP 

POPF 

RET 

AX 


END 


SAVE FLAGS 
SAVE REGISTERS 


SIGNAL THAT NO MESSAGE IS PRESENT 
SET HL FOR SHIFT OUT 


GET CONSOLE CHANNEL IN D 
FOR EACH BYTE DO 
GET BYTE IN E 


SET PARM FOR CONOUT 
SAVE CHANNEL NUMBER 
SAVE POINTER 

SEND TO COM CHANNEL 
RESTORE POINTER 
RESTORE CH NO. 
INCREASE POINTER 
END DO 

RESTORE REGISTERS 


RETURN 
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INSTALLING BACKGROUND BATCH 


Overview 

The Turbo-Plus Background Batch System operates on its own 
dedicated slave board. It requires a number of .CMD files and 
related data files. It allows job scheduling, maintains a log of 
batch operation, and offers utilities to list current and pending 
jobs and to delete jobs. 

The batch system requires two user areas: one on the system 
boot disk, and another on any drive on the system. Furthermore, 
it requires the presence of supporting .CMD files in user 0 of 
the system search drive. All of the modules can be easily 
installed in any user area using the background batch 
installation program, BBINSTAL. 

Patc hing 

The program modules which require patching are BB, BB16, 
BB16BACK, BBCANCEL, BB16CANC, BBDEL, BB16DEL, BB16BEG, BBLIST, 
BB16LIST, and BB16L0G. The patches are needed to tell the batch 

system on which user area its files will be kept. To do this 

customisation, run the BBINSTAL program Included on the 
distribution diskette. This program will issue a series of 

questions about the manner in which you want to set up your 

background batch. It will then proceed to generate the necessary 
parameter files, and start a DO process to generate the .CMD 
files, and move all of the modules to the necessary user areas on 
the system. A sample background batch installation session 
follows. All user input is underlined. 

5F) BBINSTAL 

BB requires one user area on the system boot disk where a 
WARMSTRT.AUT file will be placed. Nobody else should log 
on to this area of the boot disk. Which area would you 
like this to be? (1-30): 1 

BB requires one user area anywhere else on the system 
where it maintains all of its files. This should be 
preferably on the hard disk, if you have one. It will 
use user 0 on the drive you select. 

What drive would you like it to use? (A-P): H 

What is your system search drive? (A-P): H 

The Background Batch processor will require one slave 
board dedicated to it. Which slave will you set up 
to service the background batch? (A-P): B 
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TurboDOS 8086 Linker 

Copyright 1984, Software 2000, Inc. 

* BB 

* TPMOD 
Pass 1 

BB TPMOD 

Pass 2 

BB TPMOD 

Processing parameter file ”5f:bb.par 
DRIVE = 0x07 

Writing output file ”5f:bb.cmd” 


5F1C0PY 

* BBEGIN.CMD 01A:WRM6STRT.AUT:N 

5F:BBEGIN .CMD copied to 

* BB.CMD OH:;N 

5F:BB .CMD copied to 

* BBLIST.CMD OH:;N 

5F:BBLIST .CMD copied to 

* BBACK.CMD OH:;N 

6F:BBACK .CMD copied to 


1A:WARMSTRT 
OH: BB 
OH:BBLIST 
OH:BBACK 


* 


5F} 


AUT 

.CMD 

.CMD 

.CMD 
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Slave Generation 


Finally, a number of modifications 
must be completed: 


to your system generation 


Two changes must be made in the system .SYS files: First, a 
new slave must be generated for the batch system. This slave 
should have one change made in its .GEN file: Replace its console 
driver (typically C0N96) with CONBB.O, also supplied on user 0 of 
the installation disk. The slave’s .PAR file should be changed 
so that the slave recognizes the default warmstart filename as 
’WRM6STRT.AUT*, by inserting the patch VARMFN = *WRM6STRT’. 
Furthermore, the LOGUSR parameter should be included, setting up 
the slave to log automatically onto the user area containing 
WRM6STRT.AUT. (E.g. If you choose to warmstart into user 1 of the 
boot drive, the patch should be LOGUSR = 1.) it is also 
advisable to have this slave printing to some remote queue or to 
file, rather than directly to a printer or to console, since in 
the latter two cases it would be easy to lose desired output 
produced by any jobs running in the batch processor. This is 
accomplished via the PRTMOD and QUEPTR parameters documented in 
the TurboDOS Configuration Guide. This slave must then be 
generated into the system master file, by changing the slave 
NMBSLV parameter, and NMBXXX parameter (where XXX is the 
particular slave.) The new slave and master must be generated in 
the normal system generation manner, and the Turbo-Plus batch 
system will be ready for operation upon system reset. 
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Appendix A 

Modifying a Slave Circuit Driver for Turbo-Plus 


If you are using slave boards with incorrect circuit 
drivers, it is highly recommended that you patch the slave 
circuit driver source code (SCD???.A) in order to use TWX and 
RESET commands. 

The change to be made occurs at the end of the interrupt 
service routine in the circuit driver. If the last two lines of 

your routine are; 

STI ; Enable Interrupts 

RET I ; Return 


replace them with: 


JMP ISRXIT# ; Jump to ISR exit 

If the last two lines of that routine are different, contact your 
dealer 
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